This section describes how to upgrade from ImagXpress 12 to ImagXpress 13. While generally you'll be able to replace ImagXpress 12 with ImagXpress 13, there are a few important changes you may need to consider. This section provides information about those changes.
Library Name, GUID, and ProgID
- The library name has changed from AccusoftImagXpress12 to AccusoftImagXpress13.
- The GUID for the ImagXpress ActiveX control has changed in ImagXpress 12 from {C972AC53-2B6F-4CFD-B307-6751D0909607} to the new value in ImagXpress 13 of {D041266F-A004-40B0-A279-4E46CB10FF3D}.
- The ProgID has changed from ‘Accusoft.ImagXpress.12’ to ‘Accusoft.ImagXpress.13’.
Important Considerations
- The no_function_mapping compiler directive should be added to the #import statement for ImagXpress to avoid compiler and/or linker errors. See Import ImagXpress as a COM Object for additional information.
- When using the Platform Toolset of Visual Studio 2012, it’s recommended the library be imported using the filename instead of the ProgID, Localization ID, and Version Number to avoid complier errors. See Import ImagXpress as a COM Object for additional information.
New and Modified API
ImagXpress 13 Service Pack 1 introduces the following new or modified ImagXpress API:
- The PNGReduceFile() and PNGReduceData() methods has been added. They can compress a PNG to its optimal size while maintaining lossless fidelity to the input.
- The JPEGReduceFileEx() and the JPEGReduceDataEx() methods have been added. These new methods allow you to specify the Transform Mode of the JPEG Reduce operation.
- The enumeration IX_TransformMode has been added.
- The QueryFile2() method has been added and should be used instead of the QueryFile() method, which has been marked deprecated.
- The QueryFileV2() method has been added and should be used instead of the QueryFileV() method, which has been marked deprecated.
- The QueryCadFormat2() method has been added and should be used instead of the QueryCadFormat() method, which has been marked deprecated.
- The QueryCadLayer2() method has been added and should be used instead of the QueryCadLayer() method, which has been marked deprecated.
- The QueryCadLayout2() method has been added and should be used instead of the QueryCadLayout() method, which has been marked deprecated.
- The QueryBufferPtrV() method has been added and should be used instead of the QueryBufferPtr() method, which has been marked deprecated.
- The RGBColorCountV() method has been added and should be used instead of the RGBColorCount() method, which has been marked deprecated.
- The MatrixV() method has been added and should be used instead of the Matrix() method, which has been marked deprecated.
- PDF support is deprecated in ImagXpress, please use PDF Xpress instead for PDF support.
- The PDFSwapBlackAndWhite, SavePDFSwapBlackAndWhite, SavePDFCompression properties are marked deprecated.
- Tile-related TIFF tags from input TIFF files are now discarded during load to prevent producing invalid TIFF files during save.
ImagXpress 13 introduced the following new or modified ImagXpress API:
- Added the JPEGReduceFile() and JPEGReduceData() methods to optimize JPEGs. Use them to recompress 8-bit grayscale and 24-bit color sequential JPEG using a quality factor that requantizes luminance and chrominance. This operation can substantially reduce the size of the source JPEG. This feature is available in ImagXpress Professional.
- The performance of InsertPages() in the ActiveX interface was slower compared to the .NET control's performance. This has been improved so the performance is now similar to ImagXpress .NET.